<!-- saved from url=(0014)about:internet -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>MultiPowUpload ListItem object</title>
<link href="style.css" rel="stylesheet" type="text/css" />
<style type="text/css">
<!--
.style2 {
	font-family: "Courier New", Courier, monospace;
	font-style: italic;
	font-size: 100%;
}
.style3 {
	font-size: 0.7%;
	font-style: italic;
}
-->
</style></head>

<body>
 <table width="100%" cellpadding="0" cellspacing="0">
        <tr>
            <td width="400">

                <span class="caption">MultiPowUpload </span><span class="yellow">3.1</span>
                <br /><span class="gray">ListItem</span>
            </td>
            <td>&nbsp;
                
            </td>
             <td align="char" width="200"><img src="world.jpg" align="middle" hspace="5" /><b><a target="_blank" href="http://www.element-it.com/multiple-file-upload/flash-uploader.aspx">Home
      page</a></b><br />
                          <img src="email.jpg" align="middle" hspace="5" /><b><a target="_blank" href="http://www.element-it.com/contacts.aspx">Contact
                            support</a></b> </td>
        </tr>
</table>
<p class="topic">ListItem object</p>
&nbsp;This class represents individual file added to MultiPowUpload list.

All properties are read-only.
  
    <br>
  
    <p class="topicLeft" name="id" id="id">id (ListItem.id property)</p>
<div class="signature">
  <p>id: String [read-only]</p>
</div>
<p>Unique identificator. </p>

<p class="topicLeft" name="name" id="name">name (ListItem.name property)</p>
<div class="signature">
  <p>name: String [read-only]</p>
</div>
<p>The name of the file on the local disk. Only file name, without path. Unfortunately, it is impossible to get file path due to Adobe Flash security policy. </p>


<p class="topicLeft" name="size" id="size">size (ListItem.size property)</p>
<div class="signature">
  <p>size: Number [read-only]</p>
</div>
<p>The size of the file on the local disk, in bytes.</p>

<p class="topicLeft" name="uploadSize" id="uploadSize">uploadSize (ListItem.size property)</p>
<div class="signature">
  <p>size: Number [read-only]</p>
</div>
<p>The upload size of the file in bytes. It is the size of original file, size of original file plus size of the thumbnail or only thumbnail size, depending on upload mode. </p>

<p class="topicLeft" name="uploadThumbnailSize" id="uploadThumbnailSize">uploadThumbnailSize (ListItem.size property)</p>
<div class="signature">
  <p>size: Number [read-only]</p>
</div>
<p>The size of image thumbnail in bytes.</p>


<p class="topicLeft" name="creationDate" id="creationDate">creationDate (ListItem.creationDate property)</p>
<div class="signature">
  <p>creationDate: Date [read-only]</p>
</div>
<p>The creation date of the file on the local disk.</p>

<p class="topicLeft" name="modificationDate" id="modificationDate">modificationDate (ListItem.modificationDate property)</p>
<div class="signature">
  <p>modificationDate: Date [read-only]</p>
</div>
<p>The date when the file  was last modified on the local disk.</p>


<p class="topicLeft" name="type" id="type">type(ListItem.type property)</p> 
<div class="signature">
  <p>type: String [read-only]</p>
</div>
<p>The file type. In Windows, this property is the file extension. On the Macintosh, this property is the four-character file type.</p>

<p class="topicLeft" name="creator" id="creator">creator (ListItem.creator property)</p>
<div class="signature">
  <p>creator: String [read-only]</p>
</div>
<p>The Macintosh creator type of the file. In Windows, this property is <code>null</code>.</p>


<p class="topicLeft" name="exif" id="type">exif (ListItem.exif property)</p>
<div class="signature">
  <p>exif: Array [read-only]</p>
</div>
<p>Exif info extracted from image file. Exif info is loaded only when <a href="Events.html#onImageLoaded">onImageLoaded </a> event fired. 
	MultiPowUpload can extract exif from images compliant with EXIF 2.2 standard. JFIF standard is not supported.</p>

<b >Exif properties </b>
<table class="list">
  <tr>
    <th width="57">Propertie name </th>
    <th width="302">
      <p>Description</p>    </th>
  </tr>
  <tr>
    <td>name</td>
    <td>
      <p>Exif tag name </p>    </td>
  </tr>
  <tr bgcolor="#F8F8F8">
    <td>value</td>
    <td>
      <p>Value of  exif tag </p>    </td>
  </tr>
  <tr>
    <td>type</td>
    <td>
      <p>Type of exif tag </p>    </td>
  </tr>
  <tr bgcolor="#F8F8F8">
    <td>tagID</td>
    <td>
      <p>Tag idententificator </p>    </td>
  </tr>
</table>

<h4>Example</h4>

<pre>
	function MultiPowUpload_onImageLoaded(file)
	{
		var exifArr = file.exif;
		for(var i=0;i< exifArr.length;i++)
			alert(exifArr[i].name+" - "+exifArr[i].value+" - "+exifArr[i].type+" - "+exifArr[i].tagID);
	}
</pre>

<p class="topicLeft" name="status" id="status">status (ListItem.status property)</p>
<div class="signature">
  <p>status: Integer [read-only]</p>
</div>
<p>It is a number that represents current status of file. Possible values are listed below:</p>
<b >Status constants </b><br />
<table class="list">
  <tr>
    <th width="57">Value</th>
    <th width="160">
      <p>Name</p>    </th>
    <th width="302">
      <p>Description</p>    </th>
  </tr>
  <tr>
    <td>0</td>
    <td>
      <p><strong>STATUS_READY </strong></p>    </td>
    <td>
      <p>File is ready for processing. </p>    </td>
  </tr>
  <tr bgcolor="#F8F8F8">
    <td>1</td>
    <td>
      <p><strong>STATUS_INPROGRESS</strong></p>    </td>
    <td>
      <p>File is currently uploaded/downloaded. </p>    </td>
  </tr>
  <tr>
    <td>2</td>
    <td>
      <p><strong>STATUS_COMPLETE</strong></p>    </td>
    <td>
      <p>File was sucessfully uploaded/downloaded. </p>    </td>
  </tr>
  <tr bgcolor="#F8F8F8">
    <td>3</td>
    <td>
      <p><strong>STATUS_CANCELLED</strong></p>    </td>
    <td>
      <p>File upload/download process was cancelled. </p>    </td>
  </tr>
  <tr>
    <td>4</td>
    <td>
      <p><strong>STATUS_ERROR</strong></p>    </td>
    <td>
      <p>Error was occured while uploading/downloading the file. </p>    </td>
  </tr>
</table>


<p class="topicLeft" name="percentDone" id="percentDone">percentDone (ListItem.percentDone property)</p>
<div class="signature">
  <p>percentDone: Number [read-only]</p>
</div>
<p>Upload percent of this file.</p>
<h4>Example</h4>

<pre>
	function MultiPowUpload_onProgress(file) 
	{
		alert("Current file progress: "+file.percentDone);
	}
</pre>

<p class="topicLeft" name="serverResponse" id="serverResponse">serverResponse (ListItem.serverResponse property)</p>
<div class="signature">
  <p>serverResponse: String [read-only]</p>
</div>
<p>Server reply as a string. Populated only after  <a href="Events.html#onServerResponse">onServerResponse</a> event was fired for this file.</p>
<h4>Example</h4>

<pre>
	function MultiPowUpload_onServerResponse(file)
	{			
			alert("Reply for file: "+file.name+"\r\n"+file.serverResponse);
	}
</pre>

<p class="topicLeft" name="postFields" id="postFields">postFields (ListItem.postFields property)</p>
<div class="signature">
  <p>postFields: String[] [read-only] </p>
</div>
<p>Associative array of custom post fields specific for this file. <br />
The array also contains the values entered by a user in <a href="Parameters_ui_windows.html#descriptionWindow.caption">Description window</a> and from inline text input in <a href="Parameters_ui_fileView.html#listView.textInput.visible">List </a>or <a href="Parameters_ui_fileView.html#thumbnailView.topPanel.inputTextBox.visible">Thumbnails</a> view. </p>
<h4>Example</h4>

<pre>
		//get first file in the list
		var fields = MultiPowUpload.getFiles()[0].postFields;
		for (var fieldName in fields)
			alert(fieldName+" - "+fields[fieldName]);
</pre>

 <!--NOT_TRANSLATED BEGIN-->
<p class="topicLeft" name="isValidImage" id="isValidImage">isValidImage (ListItem.isValidImage property)</p>
<div class="signature">
  <p>isValidImage: Boolean [read-only]</p>
</div>
<p>True if image file have valid size and format for thumbnails upload. Contain correct value only if image was loaded into memory (<a href="Events.html#onImageLoaded">onImageLoaded</a> event handler)</p>


<!--NOT_TRANSLATED END-->

<p class="topicLeft" name="thumbnailFileName" id="thumbnailFileName">thumbnailFileName (ListItem.thumbnailFileName property)</p>
<div class="signature">
  <p>thumbnailFileName: String [read-only]</p>
</div>
<p>Name of image thumbnail after replacing of all placeholders in value of <a href="Parameters_function.html#thumbnail.fileName">thumbnail.fileName</a> parameter. Thumbnail is uploaded to server with that name.</p>

  <!--NOT_TRANSLATED BEGIN-->
<p class="topicLeft" name="imageWidth" id="imageWidth">imageWidth (ListItem.imageWidth property)</p>
<div class="signature">
  <p>imageWidth: Number [read-only]</p>
</div>
<p>Width of image file. Contain correct value only if image was loaded into memory (<a href="Events.html#onImageLoaded">onImageLoaded</a> event handler)</p>

<p class="topicLeft" name="imageHeight" id="imageHeight">imageHeight (ListItem.imageHeight property)</p>
<div class="signature">
  <p>imageHeight: Number [read-only]</p>
</div>
<p>Height of image file. Contain correct value only if image was loaded into memory (<a href="Events.html#onImageLoaded">onImageLoaded</a> event handler)</p>
<!--NOT_TRANSLATED END-->
<h4>Example</h4>

<pre>
	function MultiPowUpload_onImageLoaded(file)
	{			
			alert("Image file loaded. Width: "+file.imageWidth+",  height: "+file.imageHeight);
	}
</pre>

</body>
</html>
